home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / overlay.z / overlay
Encoding:
Text File  |  1998-10-20  |  6.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. oooovvvveeeerrrrllllaaaayyyy((((3333GGGG))))                                                        oooovvvveeeerrrrllllaaaayyyy((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      oooovvvveeeerrrrllllaaaayyyy - allocates bitplanes for display of overlay colors
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd oooovvvveeeerrrrllllaaaayyyy((((ppppllllaaaannnneeeessss))))
  13.      lllloooonnnngggg ppppllllaaaannnneeeessss;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _p_l_a_n_e_s   expects the number of bitplanes to be allocated for overlay
  17.               colors.  Acceptable values are 0, 2, 4, and 8.
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The IRIS physical framebuffer is divided into four separate GL
  21.      framebuffers:  normal, popup, overlay, underlay.  Because a single
  22.      physical framebuffer is used to implement the four GL framebuffers,
  23.      bitplanes must be allocated among the GL framebuffers.  oooovvvveeeerrrrllllaaaayyyy specifies
  24.      the number of bitplanes to be allocated to the overlay framebuffer.
  25.      oooovvvveeeerrrrllllaaaayyyy does not take effect immediately.  Rather, it is considered only
  26.      when ggggccccoooonnnnffffiiiigggg is called, at which time all requests for bitplane resources
  27.      are resolved.
  28.  
  29.      While only one of the four GL framebuffers can be drawn to at a time (see
  30.      ddddrrrraaaawwwwmmmmooooddddeeee), all four are displayed simultaneously.  The decision of which
  31.      bitplane to display at each pixel is made based on the contents of the
  32.      four framebuffers at that pixel location, using the following
  33.      hierarchical rule:
  34.  
  35.      _i_f           the popup pixel contents are non-zero
  36.  
  37.      _t_h_e_n         display the popup bitplanes
  38.  
  39.      _e_l_s_e _i_f      overlay bitplanes are allocated AND
  40.                   the overlay pixel contents are non-zero
  41.  
  42.      _t_h_e_n         display the overlay bitplanes
  43.  
  44.      _e_l_s_e _i_f      the normal pixel contents are non-zero OR
  45.                   no underlay bitplanes are allocated
  46.  
  47.      _t_h_e_n         display the normal bitplanes
  48.  
  49.      _e_l_s_e         display the underlay bitplanes
  50.  
  51.      Thus images drawn into the overlay framebuffer appear over images in the
  52.      normal framebuffer, and images drawn into the underlay framebuffer appear
  53.      under images in the normal framebuffer.  Popup images appear over
  54.      everything else.
  55.  
  56.      The default configuration of the overlay framebuffer is: single buffer,
  57.      color map mode.  To make a change to this configuration other than to
  58.      change the bitplane size, the drawing mode must be OOOOVVVVEEEERRRRDDDDRRRRAAAAWWWW.  For
  59.      example, the overlay framebuffer can be configured to be double buffered
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. oooovvvveeeerrrrllllaaaayyyy((((3333GGGG))))                                                        oooovvvveeeerrrrllllaaaayyyy((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      by calling ddddoooouuuubbbblllleeeebbbbuuuuffffffffeeeerrrr while draw mode is OOOOVVVVEEEERRRRDDDDRRRRAAAAWWWW.
  75.  
  76.      On models that cannot support overlay and underlay bitplanes
  77.      simultaneously, calling oooovvvveeeerrrrllllaaaayyyy with a non-zero argument forces uuuunnnnddddeeeerrrrllllaaaayyyy
  78.      to zero.  When simultaneous overlay and underlay operation is supported,
  79.      calling oooovvvveeeerrrrllllaaaayyyy may have no effect on the number of underlay bitplanes.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      doublebuffer, drawmode, gconfig, getgdesc, singlebuffer, underlay
  83.  
  84. NNNNOOOOTTTTEEEESSSS
  85.      This routine is available only in immediate mode.
  86.  
  87.      IRIS-4D G, GT, and GTX models, Personal Iris, Indy, XL, XS, XS24, XZ,
  88.      Elan and Extreme systems support only single buffered, color map mode
  89.      overlay bitplanes.
  90.  
  91.      The Personal Iris supports 0 or 2 overlay bitplanes.  There are no
  92.      overlay or underlay bitplanes in the minimum configuration of the
  93.      Personal Iris.
  94.  
  95.      IRIS-4D60G and 4D70G support 2 overlay bitplanes and 2 pop-up bitplanes.
  96.  
  97.      The Indy and XL supports 0 or 8 overlay and 2 pop-up bitplanes.
  98.  
  99.      IRIS-4DG, GT, and GTX models, XS, XS24, and Elan support 0, 2, or 4
  100.      overlay bitplanes.  Because 4-bitplane allocation reduces the popup
  101.      framebuffer to zero bitplanes, however, its use is strongly discouraged.
  102.      The window manager cannot operate properly when no popup bitplanes are
  103.      available.
  104.  
  105.      IRIS-4D VGX models support 0, 2, 4, or 8 overlay bitplanes, either single
  106.      or double buffered, in color map mode only.  The 4 and 8 bitplane
  107.      allocations utilize the alpha bitplanes, which must be present, and which
  108.      therefore are unavailable in draw mode NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  109.  
  110.      IRIS Entry does not support overlay bitplanes.
  111.  
  112.      Use ggggeeeettttggggddddeeeesssscccc to determine the maximum number of bitplanes supported for
  113.      the overlay framebuffer.
  114.  
  115.      Iris Entry does not support oooovvvveeeerrrrllllaaaayyyy so ggggeeeettttggggddddeeeesssscccc returns zero for the
  116.      number of overlay bitplanes on Iris Entry systems.
  117.  
  118.  
  119. BBBBUUUUGGGGSSSS
  120.      The Personal Iris does not support shade model GGGGOOOOUUUURRRRAAAAUUUUDDDD in the overlay
  121.      framebuffer.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.